WWWStat4Mac is a simple application designed to process the log files from httpd4Mac. It will also process log files from any application that outputs log files in the 'common log format'. This includes some UNIX web servers. So if you have a UNIX web server you might be able to process the log files on your Mac :-)
System Requirements
WWWStat4Mac requires system 7.0 or later. It would also be an advantage to have Mac TCP v1.1.1 (or later ) and Internet Config v1.1 (or later) installed to take advantage of some features. So the ideal minimal system would be System 7.5.1, MacTCP 2.0.6 and Internet Config 1.2 ( but this is only a recommendation not a requirement).
What does it do and how does it do it?
It's operation is extremely simple. Just drag your log file onto WWWStat4Mac or double click WWWStat4Mac and choose your log file using the process log menu option. The file will then be processed and you'll finally be asked to choose a
name and location for the output file.
How can I control the output from WWWStat4Mac.
The first time that you run WWWStat4Mac it creates a file called WWWStat4Mac prefs in the preferences folder. The preference file contains full documentation about all of the output options. So if you need to change the options just open the prefs file with your favourite text editor. If you are more ambitious and want to customise the output even further then all of the strings are stored inside WWWStat4Mac as STR# resources so you can change those if your prepared to use ResEdit or a similar resource editor.
What is Simple Internet Version Control (SIVC)?
The Simple Internet Version Control protocol (SIVC - pronounced "civic") is a simple TCP/IP-based system to allow developers to determine the number of people on the Internet using their products. Code is built into WWWStat4Mac that can automatically, and transparently to the user, check-in with a server at a predefined, regular interval. The server
keeps a running count of the contacts it has received in that interval (or some multiple of that interval if averaging is to be used). This provides me with a reasonably accurate estimate of the product's current user base. In return the same server returns the current versions of WWWStat4Mac and any release versions to the user. The user is then given the option to download a more upto date version of the software. More information about this system can be found at the following URL:
http://www.ots.utexas.edu/sivc/spec.html.
This version of WWWStat4Mac will only notify you of the latest release wersions and not of any development versions. If you wish to know about development versions please send me an email.
Where to get more information about WWWStat4Mac.
You can download the latest version and also find more information about
WWWStat4Mac and at the following URL:
http://sodium.ch.man.ac.uk/pages/wwwstat4mac.html
You can see the kind of output produced by looking at my server statistics at
http://sodium.ch.man.ac.uk/statistics.html
WWWStat4Mac is distributed as a FAT-Binary which will run on either 68K or PPC Macs separate 68K and PPC versions are available from the URL above for those people who know what they want :-)
_____________________
Peter Hardman phardman@ssci.liv.ac.uk
Interdisciplinary Research Centre for Surface Science
and Chemistry Department Manchester University
Oxford Road Manchester M13 9PL. England
Phone +44 (0)61 275 4640 . Fax +44 (0)61 275 4598
http://sodium.ch.man.ac.uk/home.html
_____________________
Version History Only for those with a technical interest or just plain nosey-parkers :-)
1.0.3
Added a preference that allows the user to define the default file by using the option map_default_to_file /filename.html. This makes it possible for UNIX users to define the name that '/' gets mapped to. If an old version of the prefs file exists and it has the map_default_to_home on then this automatically calls map_default_to_file with the filename of /home.html .
1.0.2
Added capabilities for wildcards in filenames and site names. So now it will be possible to exclude all machines from a site just by typing *.ch.man.ac.uk. etc. And similarly all files starting or ending with something *.gif /wwwstat4mac* etc.
Fixed a bug that caused problems with domain stats if the site name listed in the log file didn't end in a full stop '.' Now we just remove a full stop if it exists and then compare the strings. Also have now made it possible to add new domains through the new_domain option in the settings file. A domain is the Domain Name followed by the partial string that needs matching for example new_domain Apple_Computer.apple.com.
1.0.1
As always, a version ending in 0 had bugs. But only a very minor one that made the number of sites 0 if you had sites access statistics turned off. Have also increased the number of sites tracked to 4000. Hopefully I'll get some time soon to make these limits user defineable. Fixed a bug in the QUIT apple event. Now the application should quit if it was launched by dragging a file in the finder. Have also improved the speed of file saving by using a buffering system.
1.0.0 First non-development release.
Have now made the application completely 'standalone'. So when you run it without dropping a file on it you have to choose one using the file menu. Added support for SIVC (Simple Internet version control). This make the application slightly larger but means I can keep track of who is using it and lets users know when updates are available. Have made the about dialog box 'active' so that clicking on parts of it open up URL's for WWWStat4mac and Redpoint software. This requires Internet Config version 1.1 or later but is really cool :-).
Found the bug that Thom Dunaway had discovered with his clocked PowerMac. It occured today on my PB. It was going into an infinite loop at the end of the prefs file! This is now fixed!
Have added an abort while processing . This lets us abort during processing and also during saving. The progress bar now appears in the reading lines, analysing data and saving file parts.
Moved all of the strings to STR# resources. This will allow localisation to other langagus and for even more customisation of the output by users.
1.0b4 (Limited release to those people who'd sent me emails...)
Added an option to autosave the output file. This means that the program doesn't have to put up the save file dialog. This will allow files to be saved automatically and will make it easier to implement regular automatic running of the application.
Added a menubar to the program and made it so that it will now run in the background.
Added routines to convert the names of files to lowercase. This means that Setup.html is the same as setup.html.
Added mapping of / to /home.html. This is because these files are essentially the same.
Added an option to exclude files accessed by excluded sites.
Any file that is excluded, either separately or because it was accessed from an excluded site, is not included in the grand total or in the number of accesses.
Fixed a bug in the code that missed the end dates because it didn't read the last line (thanks Frank)!
Added domain statistics. Looks for all known domains as currently documented on the WWW. See preferences file for details of the URL.
I have done some timings on the latest codes for 68K and PPC and discovered that the 68K code is not that much slower than the PPC code (only about 10%). In fact the 68K code is actually FASTER (+10%) if 'Speed Emulator'
(part of Speed Doubler from Connectix) is installed!!
1.0b3.
This version adds support for various output options. These are
controlled by the file WWWStat4Mac Prefs. This file should be placed inside the
preferences folder in your system folder. If you don't do this WWWStat4Mac
will create a file containing the default preferences. If you need to change
the preferences then just edit them with your favourite text editor.
